home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / viewers / polyview / polyvw20.lha / PolyView2.0 / README < prev    next >
Text File  |  1992-05-04  |  4KB  |  138 lines
  1.  
  2. ******************************************************************
  3. *                             NCSA PolyView 2.0
  4. *                        July 24, 1990
  5. *
  6. *
  7. *    Enhancements to this software are occurring rapidly. Keep 
  8. *    looking for updates in this directory. Useful suggestions
  9. *    are likely to be implemented in new releases.
  10. *
  11. *    Portions developed at the National Center for Supercomputing 
  12. *    Applications at the University of Illinois at Urbana-Champaign.
  13. *
  14. *    THE UNIVERSITY OF ILLINOIS GIVES NO WARRANTY, EXPRESSED OR 
  15. *    IMPLIED, FOR THE SOFTWARE AND/OR DOCUMENTATION PROVIDED, 
  16. *    INCLUDING, WITHOUT LIMITATION, WARRANTY OF MERCHANTABILITY 
  17. *    AND WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE
  18. *
  19. *    Comments and suggestions may be forwarded to:
  20. *
  21. *        Ping Fu, Software Tools Group, NCSA,
  22. *        605 East Springfield Ave, Champaign, IL 61820.
  23. *        email: pfu@ncsa.uiuc.edu
  24. *        Phone: (217) 244-5603
  25. *
  26. *        -or-
  27. *
  28. *        Marc Andreesen, Software Tools Group, NCSA,
  29. *        605 East Springfield Ave, Champaign, IL 61820.
  30. *        email: marca@ncsa.uiuc.edu
  31. *        Phone: (217) 244-0013
  32.  
  33. *
  34. *    EMAIL COMMUNICATION IS PREFERRED.
  35.         polyview@ncsa.uiuc.edu 
  36. *
  37. ******************************************************************
  38.  
  39.  
  40. PolyView 
  41. ========
  42.  
  43. (1) What does it do?
  44.  
  45.     NCSA PolyView displays an HDF Vset of polygons or points at a two
  46.     or three dimensional, interactive image with optional annotation,
  47.     which may be written to a RIS8 HDF format file.  The program
  48.     also allows you to:
  49.  
  50.     -- change display projection
  51.     -- render display as points, lines, or polygons
  52.     -- choose constant or gouraud shaded polygons
  53.     -- load and manipulate the colormap
  54.     -- animate a series of vdata sets
  55.     -- view a fly-by of the data using a script file
  56.  
  57. (2) New Features of NCSA PolyView 2.0
  58.  
  59.     --keyboard-command interface
  60.     --automated creation of scripts
  61.     --dialog windows
  62.     --multiple windows and datasets in one session
  63.     --object hierarchies
  64.     --picking and querying of objects, polygonal faces, and vertices
  65.     --support for NCSA's Data Transfer Mechanism (DTM)
  66.  
  67.  
  68. (2) How is it used?
  69.  
  70.     The program reads HDF Vset files.  The HDF Vset 2.0 library
  71.     is required.  The necessary code for this application is included
  72.     in this release.
  73.  
  74.  
  75. (3) Where does it run?
  76.     
  77.     PolyView is only supported on the Silicon Graphics Personal
  78.     IRIS 4D/20G (24-bit color, 24-bit Z-buffer).  It makes extensive
  79.     use of Z-buffering.  Although it has not been tested on higher-end
  80.     IRISes, it should run on most models.  It is compiled using
  81.     shared graphics and mathematics libraries.
  82.  
  83.  
  84. (4) How can I get it?
  85.     
  86.     (a) Obtaining PolyView using anonymous ftp
  87.  
  88.         Login to zaphod.ncsa.uiuc.edu (141.142.20.50), with a login 
  89.         name of "anonymous". Give your real name as password.  Move 
  90.         to the directory "polyview" by issuing the command
  91.         "cd UNIX/PolyView/PolyView2.0".
  92.  
  93.         Read README.First to get the right version of executable 
  94.         Get sample input files from directory Examples
  95.  
  96.     (b) By remote login
  97.      
  98.         If you have an account on the NCSA Suns, you may download HDF
  99.         Vset in this way.  Login to zaphod.ncsa.uiuc.edu, cd to the
  100.         directory /sdg/ftp/polyview and copy all files in that
  101.         directory.
  102.  
  103. (5) Documentation
  104.  
  105.     ASCII and Microsoft Word documentation are available.
  106.     A bound, laser-printed copy of the document complete with
  107.     illustrations may be obtained by contacting the following address.
  108.  
  109.          NCSA Documentation Orders
  110.          152 Computing Applications Building
  111.          605 E. Springfield Ave.
  112.          Champaign, IL 61820
  113.          (217) 244-0072
  114.  
  115.  
  116. (6) Files
  117.  
  118.     In order to create the example HDF Vset file, "demo.hdf", you
  119.     should download the following files:
  120.  
  121.     makefile    md.c    df.h    dfi.h    vg.h    libdf.a    libvg.a
  122.  
  123.     The makefile will compile "md" which, in turn, is used to create
  124.     "demo.hdf".  "md.c" provides example code for creating an HDF
  125.     Vset file from scratch, and may be used as a starting point for
  126.     a data filter.
  127.  
  128.     Creating PolyView itself requires all of the files in the
  129.     v2/src directory.  Typing "make" without any parameters is
  130.     all that is necessary to create the program.
  131.  
  132.  
  133. (7) Related Items
  134.  
  135.     For further development of Vset files it is recommended that you
  136.     obtain the HDF Vset 2.1 code.  It is available via anonymous ftp,
  137.     by remote login, or direct from NCSA on tape.
  138.